home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / Commo-Support / Disk-Archive / includes-1_4.dms / includes-1_4.adf / i.zoo / dos / rdargs.i < prev    next >
Encoding:
Text File  |  1989-12-17  |  4.3 KB  |  121 lines
  1.     IFND    DOS_RDARGS_I
  2. DOS_RDARGS_I SET 1
  3.  
  4. **********************************************************************
  5. * rdargs.i
  6. *
  7. *    Copyright (c) 1989, Commodore-Amiga Inc.
  8. *    All Rights Reserved 
  9. *
  10. * This include file defines data types used in the V1.4 dos.library.
  11. * Preliminary specs subject to change.
  12. * 
  13. **********************************************************************
  14.  
  15.     IFND EXEC_NODES_I
  16.     INCLUDE "exec/nodes.i"
  17.     ENDC
  18.  
  19. **********************************************************************
  20. *
  21. * The CSource data structure defines the input source for "RdItem()"
  22. * as well as the ReadArgs call.  It is a publicly defined structure
  23. * which may be used by applications which use code that follows the
  24. * conventions defined for access.
  25. *
  26. * When passed to the dos.library functions, the value passed as
  27. * struct *CSource is defined as follows:
  28. *    if ( CSource == 0)    Use buffered IO "ReadChar()" as data source
  29. *    else            Use CSource for input character stream
  30. *
  31. * The following two pseudo-code routines define how the CSource structure
  32. * is used:
  33. *
  34. * long CS_ReadChar( struct CSource *CSource )
  35. * {
  36. *    if ( CSource == 0 )    return ReadChar();
  37. *    if ( CSource->CurChr >= CSource->Length )    return ENDSTREAMCHAR;
  38. *    return CSource->Buffer[ CSource->CurChr++ ];
  39. * }
  40. *
  41. * BOOL CS_UnReadChar( struct CSource *CSource )
  42. * {
  43. *    if ( CSource == 0 )    return UnReadChar();
  44. *    if ( CSource->CurChr <= 0 )    return FALSE;
  45. *    CSource->CurChr--;
  46. *    return TRUE;
  47. * }
  48. *
  49. * To initialize a struct CSource, you set CSource->CS_Buffer to
  50. * a string which is used as the data source, and set CS_Length to
  51. * the number of characters in the string.  Normally CS_CurChr should
  52. * be initialized to ZERO, or left as it was from prior use as
  53. * a CSource.
  54. *
  55. **********************************************************************
  56.  
  57.     STRUCTURE    CSource,0
  58.         APTR    CS_Buffer
  59.         LONG    CS_Length
  60.         LONG    CS_CurChr
  61.         LABEL    CS_SIZEOF
  62.  
  63. **********************************************************************
  64. *
  65. * The RDArgs data structure is the input parameter passed to the DOS
  66. * ReadArgs() function call.
  67. *
  68. * The RDA_Source structure is a CSource as defined above;
  69. * if RDA_Source.CS_Buffer is non-null, RDA_Source is used as the input
  70. * character stream to parse, else the input comes from the buffered STDIN
  71. * calls ReadChar/UnReadChar.
  72. *
  73. * RDA_DAList is a private address which is used internally to track
  74. * allocations which are freed by FreeArgs().  This MUST be initialized
  75. * to NULL prior to the first call to ReadArgs().
  76. *
  77. * The RDA_Buffer and RDA_BufSiz fields allow the application to supply
  78. * a fixed-size buffer in which to store the parsed data.  This allows
  79. * the application to pre-allocate a buffer rather than requiring buffer
  80. * space to be allocated.  If either RDA_Buffer or RDA_BufSiz is NULL,
  81. * the application has not supplied a buffer.
  82. *
  83. * The RDA_Template pointer is a standard AmigaDOS template string,
  84. * such as "TO,FROM/A,ALL/S".   This is defined elsewhere.
  85. *
  86. * RDA_ExtHelp is a text string which will be displayed instead of the
  87. * template string, if the user is prompted for input.
  88. *
  89. * RDA_Flags bits control how ReadArgs() works.  The flag bits are
  90. * defined below.  Defaults are initialized to ZERO.
  91. *
  92. **********************************************************************
  93.  
  94.     STRUCTURE    RDArgs,0
  95.         STRUCT    RDA_Source,CS_SIZEOF    ; Select input source
  96.         APTR    RDA_DAList        ; PRIVATE.
  97.         LONG    RDA_Buffer        ; Optional string parsing space.
  98.         LONG    RDA_BufSiz        ; Size of RDA_Buffer (0..n)
  99.         APTR    RDA_ExtHelp        ; Optional extended help
  100.         LONG    RDA_Flags        ; Flags for any required control
  101.         LABEL    RDA_SIZEOF
  102.  
  103.     BITDEF    RDA,STDIN,0    ; Use "STDIN" rather than "COMMAND LINE"
  104.     BITDEF    RDA,NOALLOC,1    ; If set, do not allocate extra string space.
  105.     BITDEF    RDA,NOPROMPT,2    ; Disable reprompting for string input.
  106.  
  107. **********************************************************************
  108. * Maximum number of template keywords which can be in a template passed
  109. * to ReadArgs(). IMPLEMENTOR NOTE - must be a multiple of 4.
  110. **********************************************************************
  111. MAX_TEMPLATE_ITEMS    equ    100
  112.  
  113. **********************************************************************
  114. * Maximum number of MULTIARG items returned by ReadArgs(), before
  115. * an ERROR_LINE_TOO_LONG.  These two limitations are due to stack
  116. * usage.  Applications should allow "a lot" of stack to use ReadArgs().
  117. **********************************************************************
  118. MAX_MULTIARGS    equ    128
  119.  
  120.     ENDC    ; DOS_RDARGS_I
  121.